# SAML SSO - Google Workspace

The ABsmartly Web Console supports SAML SSO with Google Workspace. This guide will walk you through the steps to get it set up!

## Create a new SAML App

1. Go to the [Google Admin Console](https://admin.google.com) and log in as an administrator.
2. In the sidebar, navigate to `Apps > Web and Mobile Apps`.

![Google Admin Console sidebar](/assets/images/sidebar-d9436a8bd05e418033c4e21d86c30a28.png)

3. At the top, click `Add app > Add custom SAML app`.

![Google Admin Console Add custom SAML app button](/assets/images/add_app-24a1180141fc3c8b4eea6fc164cd7a75.png)

4. Give the app a name, description, a logo and click `Continue`.

> **App Logo**
>
> You can use the ABsmartly logo by uploading [this image](https://docs.absmartly.com/assets/files/logo-0532e45efbb50515b2d04a56e20f1d5a.png).
>
> ![The ABsmartly logo](/assets/images/logo-0532e45efbb50515b2d04a56e20f1d5a.png)

![Google Admin Console Create App Step 1](/assets/images/create_app_1-ac64140b4dd7aa642dfcc526f9ef5794.png)

5. Click `Download Metadata` and save the file somewhere safe. At the end of this guide you will send your metadata to us so that we can get you set up quickly. Click `Continue`.

![Google Admin Console Create App Step 2](/assets/images/create_app_2-15b98be32617960c8d6f6a5a946d26a6.png)

6. For these fields input:

   <!-- -->

   * **ACS URL**: `https://<your-assigned-subdomain>.absmartly.com/auth/saml/google/callback`
   * **Entity ID**: `absmartly-<your-assigned-subdomain>`
   * **Start URL**: `https://<your-assigned-subdomain>.absmartly.com`
   * **Name ID Format**: `EMAIL`
   * **Name ID**: `Basic Information > Primary Email`

![Google Admin Console Create App Step 3](/assets/images/create_app_3-e15707847b1378ac0aa36d7529ad10fa.png)

7. Click `Continue`.

8. Add three Attribute Mappings for: (case-sensitive)

   * Department -> department
   * First Name -> firstName
   * Last Name -> lastName

   To assign ABsmartly roles from Google Workspace, also map a `roles` attribute, see [Assigning Roles](<https://docs.absmartly.com/docs/Third-party-integrations/SSO/SAML Role Mapping.md>).

![Google Admin Console Create App Step 4](/assets/images/create_app_4-b350e00aebdec839b5117440da6d3921.png)

9. Click `Finish`.
10. Lastly, send your metadata file to us via email or on Slack and your employees should be able to log in to the ABsmartly Web Console using their Google Workspace accounts!

> **info**
>
> Google Workspace SAML SSO works for signing in to the Web Console, but [federated OIDC access tokens](https://docs.absmartly.com/docs/APIs-and-SDKs/Federated-Authentication/federated-oidc-tokens.md#providers-that-arent-supported) aren't supported with Google: Google's access tokens are opaque, not JWTs, so ABsmartly can't verify them. Use an API key for programmatic access instead.
